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PREFACE 






id <tendaed # a : wre Medqia Manage AGN Kererer 
discusses the functions performed by the media manager and how 
they relate to each other. It helps you to use symptoms to 
narrow the area of the media manager program to be examined, and 
to associate problem symptoms with specific functions. This 
information will assist you in supplying helpful detail when 
reporting new problems to the IBM Support Center. 


This book is organized as follows: 


Chapter 1, "Program Overview" on page 3, gives an external 
overview of the media manager program and each of the functions 
it performs. 


Chapter 2, "Program Functional Description” on page 5, describes 
the functional area of the media manager program product. This 
includes the function-to-function relationships, and the 
principal processing paths through each of the functions. 


Chapter 3, "Module Directory" on page 9, provides a media 
manager module-to~module cross reference. 


Chapter 4, "Control Blocks and Data Areas" on page 12, describes 
the control blocks and data area linkages used by the media 
manager. 

Chapter 5, "Service Aids" on page 30, contains a description of 
the media manager dump and its output. It also describes 
diagnostic tools that can be used to collect information on 
program failures. 


Appendix, "Return Codes" on page 32, lists the return codes that 
are provided when errors occur. 


"list of Abbreviations" on page 34, defines the abbreviations 
used in this book. 


PREREQUISITE KNOWLEDGE 


In order to use this book efficiently, you should be familiar 
with the following topics for system control programs: 


e Dump analysis 


° Diagnostic practices 


bt 
quale 
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RELATED PUBLICATIONS 


Within the text, references are made to the publications listed 
in the table below: 


Order 


Debugging LC28-11642 
Handbook » iS CExtended—Architeetyce 1 LC28-1165 

serie 5 LC28-1166 
LC28-1167 
LC28-1168 





























Programming 







System Proaramina-Svsten General 
General 
Information 
— 


Supervisor 
peryeces and 
Macro 






Instructions 





System Hr 1376 
Messages 

enna Volumes fessade Library. —Syaten and 2 aces- 1377 
_ cau 


Note 


i All five volumes may be ordered under one order number, 
LBOF~1015. 
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SUMMARY OF CHANGES 


| RELEASE 3,0. JUNE 1987 


The procedural diagnosis information in this manual ne been 
moved to the. new 

Consequentially, the title has been Ranged to 
indicate that the manual now contains only diagnosis reference 
information. 


| NEW ENHANCEMENTS 
Information was added to "Data Areas" on page 18 and the 


eee "Return Codes" on page 32, for support of linear data 
sets. 


RELEASE 1.0, APRIL 1985 


NEW ENHANCEMENTS 


@ The release level keyword, which was optional in earlier 
releases, iS now required. 


e Return codes for common errors have been added in the 
appendix. 


VERSION 2 PUBLICATIONS 


The preface includes order numbers for Version 2 books. 
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INTRODUCTION 


This publication describes the media manager in terms of its 
functions. For purposes of this publication, function is 


defined as a logically distinct group of modules that performs a 


major part of a program's processing. 


This publication is not intended to show you the procedural 


steps involved in diagnosing a media manager problem, nor how to 


modify or repair the program logic. It will, however, give you 
an adequate basis for communicating with an IBM program 
specialist about possible program failures. 


The information contained in this book is organized to support 
the diagnostician in analyzing the process being performed. 


This book is organized as follows: 


"Program Overview" on page 3 presents an overview of the media 
manager, its purpose, and its functions. It is intended to 
provide a quick grasp of the processing performed by the media 
manager. 


"Program Functional Description" on page 5 describes the 
principal processing paths through each function. 


"Module Directory”™ on page 9 shows the module-to-module 
communication and the functions and sub-functions in which the 
noe ae involved. A brief description of each module is also 
include | 


"Control Blocks and Data Areas" on page 12 describes key data 


areas used for communications between the functional areas, and 


shows the data area linkages. 


"Service Aids" on page 30 contains descriptions of dumps and 
se ata how to analyze diagnostic information for this 
product. 


HOW TO USE THE REFERENCE MATERIALS 


The following sections explain how to look for information that 


pertains to a specific function or module. 


FINDING THE MODULE IN A FUNCTION 


To find out what module carries out a specific function, follow 


these steps: 


1. Under "Program Functional Description" on page 5 and under 
the function heading you have chosen, find the name of the 
controlling module and the modules it calls in the 
processing sequence. One of these modules is likely to 
contain the code you are looking for. 


2. If you want to know which modules call and are called by the 


particular module, look at the entry for that module under 
"Module Directory" on page 


Let's take an example. Suppose you want to know what module 
builds the channel program for a read request. 


1. Under "Program Overview" on page 3, find the function 


OP=RDWR in Figure 1. The description of OP=RDWR states that 
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this function processes reads and writes for the data 
portion of records. 


2. Under "Program Functional Description” on page 5, find the 
section on the RDWR function. 


3. Look at the descriptions of the controlling module and the 
modules called to perform the RDWR function. The module 
ICYBLDCP is likely to be what you are looking for. 


4. If you want to see which modules call ICYBLDCP or which 
modules it calls, find the entry for ICYBLDCP under "Module 
Directory" on page 9. 

FINDING THE FUNCTION OF A MODULE 

If you want to gain a general understanding of the context (or 

area of function) within which a module operates, the modules 

that call this module, and what they do, follow these steps. 

1. Under "Module Directory" on page 9, opposite the name of the 
module you are interested in, find the names of the 
functions it participates in. 


2. See the descriptions of the functions in "Program Functional 
Description"™ on page 5. 


3. If you want a more general view, see Figure 1. 


For example. If you wish to find out what media manager function 
uses ICYBLIST, do the following: 


l. The entry in "Module Directory" on page 9 tells you that it 
is used by the RDWR and FMTWR functions. 


2. <A description of the functions is in "Program Functional 
Description" on page 5. 
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PROGRAM OVERVIEW 


This section presents an overview of the media manager program, 
its purpose, and its functions. It also describes how the media 
manager interacts with other programs. 


The media manager is a component of the MVS/Extended 
Architecture Data Facility Product (MVS/XA DFP), Program Product 
Number 5665-XA2. 


It enables a caller to use relative byte addresses in requests 
to read and write data, and to pre-format a range of relative 
byte addresses on a direct access storage device (DASD). With 
relative byte addressing, the caller is independent of the 

device architecture and the channel programs required for I/0. 


The media manager performs the following services: 


e The INIT function builds and initializes the control blocks 
required to perform I/0. 


e The RDWR function reads or writes the data portion of a 
logical record (control interval) on a DASD device. 


e The FMTWR function writes count fields and data sequentially 
on a DASD device. 


¢ The PFMT function pre-formats one or more DASD devices for a 
range of relative byte addresses. 


@ The CNVT function changes relative byte addresses to 
absolute device addresses (CCHHR), and vice versa. 


e The MMSYSTEM function manages media manager resources. The 
modules used by the MMSYSTEM function are: ICYELE, ICYFRR, 
and ICYPURG. In addition, a system function manages media 
manager resources. 


® The SRV function interfaces with the integrated catalog 
facility catalog to obtain data set information and to 
update that information when explicitly requested. 


Macros issued by the calling program invoke most media manager 

functions. There are four macros: MMINIT, MMCALL, MMSRV, and 

MMCNVT. Figure 1 on page 4 shows the functions invoked by each 
of the macros and the controlling module for each function. 
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MMINIT macro MMCNVT macro 
ICYRBA/ 
ICYINIT ICYCCHHR 


Converts RBA to 


CCHHR and vice 
versa 





Sear 
media manager 


INIT function CNVT function 


MMCALL macro 


ICYRDWR 


Reads and 
update-writes 
data portion 

of records 


ICYPFMT 


Preformats an 
RBA Range 

















Formats, 
tracks, and 
writes data 








RDWR function FMTWR function PFMT function 


MMSRV macro 








OP=CONNECT OP=DISCONNECT OP=EXTEND OP=CATREAD OP=CATUPDT 
ICYMMSRV ICYMMSRV ICYMMSRV ICYMMSRV ICYMMSRV 
Initializes Disconnects Acquires 
control a media additional 
blocks manager user space for a 
from a data data set 
set RBA to caller 
CONNECT DISCONNECT EXTEND CATALOG READ CATALOG UPDATE 
function function function function function 


Figure 1. Functions Invoked by Media Manager Macros 
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PROGRAM FUNCTIONAL DESCRIPTION 


CNVT FUNCTION 


FMTWR FUNCTION 


This section describes the principal processing paths through 
each function and describes how the functions interact with each 
other. The functions are arranged alphabetically for easier 
reference. 

From this section, you can relate external input to the 
processing of a function. The functions named in this section 
are those described in "Program Overview" on page 3. 

The names of the functions are the titles of the main parts of 
this section. Under each function name is the description of 
the function's operation, as follows: 

INPUT: Describes the input requirements for the function. 
PROCESSING: Describes the processing the function performs. 


RESULTS: Describes the results or output consequent to the 
execution of this function. 


INPUT: Register 0 for ICYCCHHR points to the UCB for the device 
containing the extent. 


Register 1 points to the convert parameter list CICYCPL). 
The controlling modules are ICYRBA and ICYCCHHR. 


PROCESSING: On receiving control, ICYRBA Cor ICYCCHHR) proceed 
as follows: 


® ICYRBA converts RBAs to CCHHRs. 
® ICYCCHHR converts CCHHRs to RBAs. 


RESULTS: RBA or CCHHR conversions are processed as specified in 
the calling program's request. 


INPUT: Register 0 contains parameter information. 

Register 1 points to the first element (MMRE) of an I/0 request. 
Register 2 points to the MMIB. 

The controlling module is ICYFW. 

PROCESSING: On receiving control, ICYFW proceeds as follows: 


e Calls ICYSTOR to acquire work space and build the MMPB, 
indicating that requests are for format-write 


® Establishes a functional recovery routine CFRR) 

e Arranges the request elements in the chain in RBA sequence 
8 Calls ICYBLIST to build a list of control interval elements 
suitable for RBA-~to-CCHHR conversion and channel program 

build 
® Calls ICYRBA to convert RBAs to CCHHRs 


® Calls ICYBLDCP to build I/0 control blocks and channel 
programs 
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6 Passes control to the I/O supervisor via the STARTIO macro 
to start input/output 


e Returns to the calling module, and the I/0 continues 
asynchronously 


When the I/0 is completed, ICYDIE/ICYNRM receives control, 

releases storage, and returns to the calling program via 

Ae eee depending on the return code from the calling program's 
exit. 


When the I/0 fails, ICYABN receives control and returns to the 
calling program always via ICYPGAD. 


RESULTS: Format write requests are processed as specified by 
the calling program. 


INPUT: The INIT function requires, as input, certain DASD 
device characteristics such as tracks per cylinder, bytes to be 
papel ens queens and starting and ending device addresses for 
each extent. 


Register 1 points to the calling program's parameter list that 
contains information needed to build EDBs and LPMBs. 


The controlling module is ICYINIT. 

PROCESSING: On receiving control, ICYINIT proceeds as follows: 

@ Builds extent definition blocks CEDBs) and 
logical-to-physical mapping blocks (CLPMBs) as required for 
each extent for each volume entry specified 

® Uses information in device blocks describing the physical 
ah of the data set and the device to construct 

s 


® Initializes the media manager interface block (MMIB) with 
the addresses of the EDB and LPBM storage 


RESULTS: The MMIB is now complete for processing calling 
Program requests. 


INPUT: CNo input used) 

PROCESSING: The MMSYSTEM function proceeds as follows: 

e ICYELE waits for notification from the system resource 
manager of a low system queue area CESQA) condition and 
frees unused media manager storage. 


@ ICYFRR records information in the SYS1.LOGREC and 
SYS1.DUMPnn data sets for indeterminate errors or system 
X'*COD* abends within the media manager. 


e ICYPURG releases system resources held by the media manager 
or VSAM when a PURGE HALT request is received. 


RESULTS: (No output produced) 
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PFMT FUNCTION 


RDWR FUNCTION 


INPUT: Register 0 contains parameter information. 

Register 1 points to the I/0 request element CMMRE). 

Register 2 points to the MMIB. 

The controlling module is ICYPFMT. 

PROCESSING: On receiving control, ICYPFMT proceeds as follows: 
e Calls ICYSTOR to acquire work space and build the MMPB 

e Establishes a functional recovery routine CFRR) 

° Calls ICYPFCP to set up a channel program to format a track 


e Builds the I/0 control blocks to interface with the I/0 
supervisor 


® Passes control to the I/O supervisor via STARTIO macro to 
start I70 


8 Returns to the calling module, and I/0 continues 
asynchronously 


On return from the I/0 supervisor (IOS), ICYPFDIE calls ICYPFCP 
to format another track. If another track is required, ICYPFDIE 
re-drives the I0S. If finished, ICYPFDIE schedules ICYPGAD to 
return to the calling program. If an error occurs, ICYPFAPP gets 
control Cin order to interface with user error routines, if they 
exist) before returning to the calling program via ICYPGAD. 


RESULTS: Pre-format requests are processed as specified by the 
calling program. 


INPUT: Register 0 contains parameter information. 

Register 1 points to the first element (MMRE) of an I/0 request. 
Register 2 points to the MMIB. 

The controlling module is ICYRDWR. 

PROCESSING: On receiving control, ICYRDWR proceeds as follows: 


e Calls ICYSTOR to acquire work space and build the MMPB that 
keeps track of read/write processing 


e Establishes a functional recovery routine 

e Calls ICYSORT to sort the request elements in the calling 
program's request by relative byte address for efficiency of 
input/output, if specified by the calling program 

e Calls ICYBLIST to build a list of control interval elements 
suitable for RBA-to~-CCHHR conversion and channel program 
build 

6 Calls ICYRBA to convert RBAs to CCHHRs 


e Calls ICYBLDCP to build I/0 control blocks (SRB and IOSB) 
and channel programs 


® Passes control to the I/0 supervisor 


e Returns to the calling module, and I/0 continues 
asynchronously 


LY26-3965-1 © Copyright IBM Corp. 1980, 1987 Program Functional Description 7 


Restricted Materials of IBM 
Licensed Materials ~ Property of IBM 


When the I/0 is completed, ICYDIE/ICYNRM receives control, 

releases storage, and returns to the calling program via 

ie cee. depending on the return code from the calling program's 
exit. 


When the I/0 fails, ICYABN receives control, and returns to the 
calling program, always via ICYPGAD. 


RESULTS: Read/write requests are processed as specified by the 
calling program. 

SRV FUNCTION 
INPUT: The SRV function consists of five sub-functions: 
CONNECT, DISCONNECT, EXTEND, CATREAD, and CATUPDT. The media 
manager services parameter list (MMSPL) contains the DDNAME 
specification or the specification for the data set or a valid 
parameter list for sub-functions other than CONNECT. This MMSPL 
list is required as input. Register 1 points to the calling 
program's parameter list. 
PROCESSING: On receiving control, ICYMMSRV proceeds as follows: 
° Builds the media manager services work area (MSWA) 
¢ Creates a dummy ACB to interface with VSAM 
e Calls VSAM for CONNECT, EXTEND, DISCONNECT 


- Issues SVC 26 to obtain or update required catalog 
information 


- Returns to calling program 


RESULTS: The sub-function is complete or a return code is 
passed to the calling program. 
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MODULE DIRECTORY 


This section shows the module-to-module communication within the 
program. Module information is organized alphabetically and is 
useful when following the flow between modules and when 
verifying what processing has taken place. The following table 
lists all media manager modules, and gives for each module: 

® The functions to which it belongs 

® The names of the modules by which it is called 

® A brief description of what it does 

6 The name of the modules it calls 

e The name of the module to which it exits 


In both the "Called by™ and the "Calls" column, a name in 
parentheses refers to another system component, as follows: 


ros I/0 supervisor 

SRM system resource manager 

ENF event notification facility 
VSAM virtual storage access method 
VSM virtual storage manager 
Legend: 


< > Indicates an indirect call by scheduling an SRB. 


£{ 1 Indicates a branch. 


ICYABN RDWR I0S interface, 
FMTWR abnormal end append- 
age 
ICYBLDCP RDWR ICYDIE Builds channel ICYSTOR 
FMTWR ICYFW Program 
ICYPGAD 
ICYRDWR 
ICYBLIST RDWR ICYFW ICYSTOR 
FMTWR ICYRDNR 
RBA conversion and 
channel program build 
FMT 


ICYCCHHR CNYT ICYPFAPP Converts device calling 
P address to relative program 
byte address 


ICYDIE RDWR Interface between I05S ICYBLDCP ToS +¢0, 
FMTWR <ICYPGAD> | 4 or 8) 
ICYRBA 
ICYSTOR 


and calling program's 
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Ios + €0 
or 8) 
ICYNRM 















calling 
program 















Builds a list of 
control interval 
elements suitable for 


calling 
program 

































DIE routine for 
read-write and 
format-write requests 
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calling 
program 








ICYIEDB 


ICYILPMB 


ICYINIT 


ICYMMSRV 





ICYELE MMSYSTEM Upon notification from 
ENF, frees media 
manager stor- 
age blocks 
ICYFW FMTWR Processes format-write ICYBLDCP calling 
requests ICYBLIST program 
ICYSTOR 
INIT ICYINIT Builds extent defi- ICYILPMB calling 
nition block program 
INIT Initializes media ICYIEDB calling 
manager control blocks program 
SRV Access the integrated calling 
catalog facility program 
catalog to build a 
media manager control 
block structure 
ICYMSTAE 
program 
. 


routine | Program 
ICYRBA 
INIT ICYIEDB Builds : calling 
logical-to-physical program 
mapping block 
CRTM) ICYMMSRV ESTAE routine calling 


ICYNRM RDWR CICYABN] I0S interface, normal calling 


FMTWR CIOS) end appendage 


I0S interface, ICYCCHHR calling 
appendage that pre- program 
formats by RBA range 
PFMT ICYPFMT Builds channel pro- ICYRBA calling 
ICYPFDIE gram to preformat ICYSTOR program 
within an RBA range 


program 


ICYPFAPP | PFMT 


ICYPFCP 


ICYPFDIE PFMT Interface between I0S ICYPFCP Same as 


pre~format func" <ICYPGAD> ICYDIE 


tion for redriving I/0 
until all tracks are 
formatted 





ICYPFMT 


PFMT Processes requests to ICYPFCP calling 
pre-format within an ICYSTOR program 
RBA range : 

ICYPGAD RDWR <ICYDIE> IOS interface, ICYBLDCP system 

FMTWR <ICYPFDIE>| termination routine ICYRBA 

CIOS) ICYSTOR 

ICYPURG MMSYSTEM | I0S interface, purge calling 

routine 


program 


Converts relative byte calling 
address to CCHHR program 
address 


10 MVS/XA Media Manager Diag. Ref. LY26~3965-1 © Copyright IBM Corp. 1980, 1987 


ICYRBA 


ICYDIE 


ICYRDWR 





Restricted Materials of IBM 
Licensed Materials ~ Property of IBM 


_ ae 

ICYSORT ICYRDWR Sorts I/0 request 
elements for 
input/output 
efficiency 


ICYSTOR 


bescription | cate | exits to 


Processes read and ICYBLDCP calling 
ICYBLIST 
ICYRBA 



























update-write requests program 


ICYSORT 
ICYSTOR 





calling 
program 




























ICYRDWR Acquires space in main CVSM) calling 
storage for the media Clock program 
manager manager ) 





ICYBLIST 
ICYBLDCP 
ICYDIE 
ICYPGAD 
ICYPFCP 
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This section describes the data areas (control blocks) used for 
communication between functions, programs, or parts o e 
system. This information is useful for interpreting storage 
dumps and for determining the program's and system's status at 
the time of failure. Only those data areas are documented that 
consent fields that direct processing from one function to 
another. 


The media manager uses control blocks and data areas to map 
relative byte addresses to the actual device address. The media 
manager also builds internal control blocks to allow control of 
the I/0 process and to maintain storage that is allocated to the 
media manager. 


Where appropriate, key data areas have been provided. These are 
listed following the related control block. 


Media manager functions use control blocks and data areas as 
follows: 


Functions Data Areas 


INIT EDB, IDEVB, IPLST, LPMB, MMIB 
RDWR>» EDB, LPMB, MMIB, MMPB, MMPT, MMRE, MMSB, 
FHTWR, MMSV, MMVR 
PFMT 
CNVT CPL Cpart of MMPB for use by media manager; 
separate data area for calling programs) 
SRV MMSPL, MSWA 


Note: The prefix ICY is part of the mapping macro names on 
microfiche. 
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CONTROL BLOCK LINKAGES 


Figure 2 shows a control block chain for initialization; 
Figure 3 on page 14 shows a control block chain for I/0 


processing. 
Register 1 
Initialization MM interface Extent 
VY parameter list block definition block 


16¢€10) 


04(004) 














DB 
subpool length 


@ LPMB 
subpool length 


Volume entry 1 

address device 
block 1 

extent entry 






2801C) 
00C00)% 









Logical-to- 
physical 
mapping block 


extent entry 






Device blocks 


> 
device block ] 


>| device block 2 


Volume entry 2 
@ device block 2 
extent entry 









00(00)* 






extent entry 


Legend: 
@ Indicates pointer to. 
Note: 


¥ The offset is taken from the beginning of the entry. 


Figure 2. Control Block Chain, Initialization 
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Register 1 Register 2 







MM Request 
Element 


MM Interface 
Block 


ID 


















04 (04)| ID 16 (10) 
@ next MMRE @ EDB 
@ buffer Subpool 
28 (1C) mA 
RBA @ LPMB 
Subpool 


Length 


MM Request 

Element Extent 
Definition 

ID Block 


O if last 
@ buffer 


Volume Entry 
@ LPMB 


Volume Entry 





RBA 








Buffer @ LPMB 
Logical-to- 
Physical 

Buffer Mapping Block 


Notes: 1. The offset is taken from the beginning of the entry. 
2. @ is pointer to. 


Figure 3. Control Block Chain, Input/Output Processing 
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CVT + X'148’ 
CVT Extension MMSB 
16 (10) 
CVT MMVT 
t LOCK 
t 1st Segment 
MMVT t Next Owned MMSB 


MMVT copyright 


tT Entry Modules 


Pointer to MMSB 


t Next Segment 
Segment Lock 


t Other Modules 





Patch Area 


SRB/IOSB Skeletons 





First MMSV ; 
Eye Catcher (EBCDIC ICYMMSV1) Last segment header is a dummy 
of ali zeros. 
32 
bop bo -_ 
X'8000 
000" T Next MMSV LOCK = QOCOFFFB = MMSentry not used 
= QOOO FFFD = Held by event listen exit 
= QOOO FFFF = Storage block available 
= 80000000 = Entry points to next MMSV 
First MMPT = QO000ASID = Locked —caller’s ASID 


4 


7 NEXT 
Eye-Catcher t MMPT 


t MMPB t MMPB 


+ MMPB t MMPB 


t MMPB t MMPB 


Note: ICYMMSV 11 is the first MMSV. 


Figure 4. Media Manager Storage Block Linkages 
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DESCRIPTIONS OF CONTROL BLOCKS AND DATA AREAS 
Following is a brief description of control blocks and data 
areas needed for diagnosis in the media manager. 
ICYCPL: CONVERT PARAMETER LIST 
Pointed to by: Register l. 
Storage Location: Specified by calling program. 


Description: Used by the convert routines to change RBA to 
CCHHR and vice versa. 


Created: By calling program. 


Released: By calling program. 


ICYEDB: EXTENT DEFINITION BLOCK 
Pointed to by: ICYMMIB. 


Storage Location: Specified by calling program or obtained in 
MMINIT processing. 


Description: Describes data set extents. There are one or more 
extent definition blocks for each data set. The extent 
descriptions in an EDB are in ascending RBA sequence. For each 
extent, the description includes the address of the associated 
LPMB, the starting and ending RBA, and the address of the UCB 
for the device associated with this extent. 

Created: By execution of the MMINIT macro. 


Released: By calling program. 


ICYIDEVB: MEDIA MANAGER INITIALIZATION DEVICE BLOCK 
Pointed to by: ICYIPLST. 
Storage Location: Specified by calling program. 
Description: Contains device-related data set information for a 
device type. Includes the length of a block, the unit of 
allocation, the physical block size, the control interval size, 
and the control area size for a specific device type. 
Created: By calling program. 


Released: By calling program. 


ICVIPLST: MEDIA MANAGER INITIALIZATION PARAMETER LIST 
Pointed to by: Register 1. 
Storage Location: Specified by calling program. 
Description: Has a pointer to the MMIB. Contains data set 
information for one or more volumes. Each volume entry includes 
the addresses of the unit control block (UCB) and device block 
for the device on which the volume is to be mounted; the low and 
high RBAs; and the beginning and ending cylinder and head 
addresses. 
Created: By calling program. 


Released: By calling program. 


16 MVS/XA Media Manager Diag. Ref. LY26-3965-1 © Copyright IBM Corp. 1980, 1987 


Restricted Materials of IBM 
Licensed Materials ~ Property of IBM 


ICYLPMB: LOGICAL~TO-PHYSICAL MAPPING BLOCK 
Pointed to by: ICYEDB. 


Storage Location: Specified by calling program or obtained in 
MMINIT processing. 


Description: Maps the descriptions of the data set extents in 
an EDB to the physical characteristics of the device type on 
which the volume resides. 

Created: By execution of the MMINIT macro. 


Released: By calling program. 


ICYMME: MEDIA MANAGER INTERFACE BLOCK EXTENSION 
Pointed to by: ICYMMIB, ICYMME. 
Storage Location: Specified by calling program. 
Description: Describes an extension of MMIB storage. 
Created: By calling program. 


Released: By calling program. 


ICYMMIB: MEDIA MANAGER INTERFACE BLOCK 
Pointed to by: ICYMMPB, ICYIPLST, Register 2. 
Storage Location Register 2: Specified by calling program. 
Description: Provides linkages between the media manager and 
the calling program requesting I/O services. Includes pointers 
to the EDB and LPMB, the length of those blocks, and sub-pool 
information; and the addresses of the calling program's exit 
routines. 
Created: By calling program. 


Released: By calling program. 


ICYMMPB: MEDIA MANAGER PROCESS BLOCK 


Pointed to by: IOSB CIOSUSE); register 11 for the majority of 
media manager processing. 


Storage Location: System queue area, within an MMSB. 
Description: Describes the process being performed. Flags 
indicate whether the process is read, update-write, 
format-write, or pre-format. A l-byte module identifier in 
field MMPMODID of the MMPB at offset X*1C* identifies the last 
media manager module in control. 

Created: During request initialization. 


Released: At request termination. 
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Offset 
Dec. (Hex. ) 


MMPBID 


MMPNSRT 
MMPREAL 


7 (7) 
8 (8) 


MMPKEY 


MMPFLG2 
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MMPBPARM 


MMPNDSBL 


MMPDEPNO 
MMPBYPCL 


MMPASIDR 


/ 
~” 


MMPPTCBA 
MMPCLEAR 


MMPMODID 


rm 
= 
Cc 
A 
= 
© 
© 
o 
rm 
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Description 

MEDIA MANAGER PROCESS BLOCK 
EBCDIC IDENTIFIER 'MMPB! 

INPUT PARAMETERS RO, R1, R2 
REGISTER 0 AT ENTRY 

INPUT FLAGS | 

DO NOT DO BUFFER ADDRESS CHECK 
DO NOT SORT MMRE CHAIN 


MMRE HAS REAL (NOT VIRTUAL) 
BUFFER ADDRESSE 


FRR NOT WANTED FOR FRONT END 
CUSE EUT FRR 


DO NOT DISABLE IN FRONT END 
SEQUENTIAL ACCESS 

REQUESTS ARE NOT DEPENDENT 
BYPASS CACHE LOAD 

PROTECT KEY FOR I/0 

POINTER TO MMRE CHAIN 
POINTER TO MMIB 

USERS SAVE AREA REGISTER 
ASID FOR COMPARE AND SWAP 


ASID USED FOR SDUMP 
PURGE TCB ADDRESS 


PORTION OF MMPB TO BE CLEARED 
AT MMPB CREATION 


FCTURNLe CODE PORTION OF THE 


GENERAL FLAGS CSOME ARE 
DECLARED BELOW AS ABNORMAL) 


AT LEAST ONE MMRE IN THE 
REQUEST WAS IN ERROR 
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Offset 


Dec. (Hex. ) Description 


DEPENDENCIES EXIST BETWEEN 
MMRES IN THE REQUES 


DO NOT ENTER USERS TERMINATION 
ee gee FORMAT WRITE REQUEST 
PREFORMAT REQUEST 

ALL IOSBS FINISHED 

PCK IN IOS OR FRR ENTERED 

| MMPPURGE | PURGE ENABLED 

FLAGS DECLARED ABNORMALLY 
SAME AS MMPERR 


MMPPCKAB | SAME AS MMPPCK 


MMP2FLG FLAGS FOR USE BY SECOND LEVEL 
MODULES 
MMPFLG3 


I70 PREVENTED 
NOT USED 


ADDRESS OF FIRST OWNED MMSB 
CLAST MMSB ACQUIRED) 


ADDRESS FIRST STORAGE SEGMENT 
CLAST SEGMENT ACQUIRED) 


FIRST FREE BYTE 
FREE LENGTH 


ADDRESS OF LIST ELEMENT FOR 
NEXT CI TO PROCESS 


PHYSICAL RECORDS 
NUMBER OF IOSBS STARTED 
NUMBER OF IO0SBS FINISHED 
NUMBER OF IOSBS 


NUMBER OF ELEMENTS IN MMPLIST 

LENGTH OF CHANNEL PROGRAM AREA 

Neckar LOCK FOR ICYFREE. 00 = 
DISABLED, FF = ENABLED 

| MMPSMSK | SAVE AREA FOR SYSTEM MASK 

ADDRESS CHANNEL PROGRAM AREA 


MMPRETCD | RETURN CODE 


e111 1111 


44 €20) 


70 (€46) 


71 (47) 
72 (48) 
76 (4C) 
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-vene__| soseription 


Twerevss [ssss 
Co 
Twirrerce [eo 

ADDRESS OF WAT ENTRY 












offset 
Dec. (Hex. ) 


78 (4E) 


79 (GF) 


80 (50) 


88 (58) 


MMPMMPT ADDRESS OF MMPT ENTRY 


MMPIPIB ADDRESS OF IPIB IF PURGE IN 


cc 
PROGRESS 
ADDRESS OF USER PURGE EXIT 






96 (60) MMPFRRWA | ADDRESS OF FRR WORK AREA 
MMPLIST1 FIRST ELEMENT IN MMPLIST 


124 (7C) FIRST IOSB AREA 


72 SAVE AREA FOR CALLING ICYSTOR 
AND ICYRBA 


428 C1AC) GENERAL SAVE AREA 
WORK AREA 


SAVE AREA FOR FRONT END WHEN 
BACK END MAY BE PROCESSING. 
MAY NOT BE USED BY BACK END 










Offset 
Dec. (Hex. ) 


tenet pescription 
MMPLIST | CI LIST ELEMENTS FOR WHICH 170 
WILL BE DONE 


CmrPRRREP | ADDRESS OF THE WARE 
CwPLSEOE | LAST LIST ENTRY FOR SEOMENT 
mersvox | RESERVED 
rps | SEARCH PREV. CHANNEL PROORAN 
Teta | BEOINNING BBCcHHR a SECTOR 
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Offset 
Dec. (Hex. ) 
6 (6) 

6 (6) 


Description 
BEGINNING BBCCHHR 
BEGINNING BB 


FLAGS SET BY RBA CONVERT FOR 
CHANNEL PROGRAM 


THIS CI CONTIGUOUS WITH PRIOR 


MMPLBSK 
MMPLBB 
MMPLSTF1 


MMPLCTIG 


MMPLSCYL CI ON SAME CYLINDER AS 


REVIOUS 


MMPLSTRK {| CI ON SAME TRACK AS PREVIOUS 


MMPLSEXT | CI IN SAME EXTENT AS PREVIOUS 


pen 4 be 
oO 
aad 
w 
Cc 


MMPLSRW CI IS SAME READ/WRITE 


OPERATION AS PREVIOUS CI 





MMPLECKD 
MMPLLR 
MMPLDE 


EXTENT IF FOR FULL ECKD 


LOCATE RECORD SUPPORTED 
DEFINE EXTENT SUPPORTED 
7 (7) 


MMPLSTF2 | FLAGS FOR USE BY CHAN PROG 


8 (8) 
8 (8) 
8 (8) 
8 ¢€8) 


MMPLBCHR 
MMPLBRBA 
MMPLBCH 
MMPLBC 
MMPLBH 
MMPLBR 
MMPLSSEC 
MMPLE 
MMPLECHR 
MMPLECH 
MMPLEC 
MMPLEH 
MMPLER 
MMPLESEC 
MMPLEDBP 


BEGINNING CCHHR 
BEGINNING RBA 
BEGINNING CCHH 
BEGINNING CC 


STARTING SECTOR 
ENDING CCHHR & SECTOR 
ENDING CCHHR 

ENDING CCHH 

ENDING CC 


14 CE) 


ENDING SECTOR 


ADDRESS OF EDB EXTENT FOR THIS 
CONTROL INTERVA 


MMPLNEXT | ADDRESS OF MORE LIST ELEMENTS 
CVALID IF MMPLCNT ON) 


=] 

one 

aa] 

| on 

o 
re 
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Offset 

Dec. (Hex. ) Length Description 

0 (0) SRB/IOSB AREA. THE IOSB IS THE 
FIRST ITEM IN THE AREA AND 
IOSUSE POINTS TO THE MMPB 














ADDRESS OF NEXT MMPIO AREA 


co 

re one ron 

pro |__| mrrocme | Sonn Repetbage OR USE PY 

NORMAL APPENDAGE 

Tse [2 were [ec 
risen [2 | wwrson [we SSC 
aco can) [a wrsor [RSS 
hen fa 
[ase cam [2 
a ry 


MMPIOF2 FOR USE BY DIE AND APPENDAGES 


MMPIOFI FLAGS SPECIFIC TO THIS IOSB 
MMPIOGERR | AY LEAST ONE MMRE IN ERROR 







SEGMENT HAS BEEN BROKEN FOR 
ERROR RECOVERY AND INCOMPLETE 
WHEN I70 FINISHES 










haem 
4 


MMPCPINC 
164 (AG) } 64s | - MMPIOSAV SAVE AREA FOR APPENDAGES 


MMPCFRBA | ADDRESS OF FIRST CI LIST ENTRY 
FOR PORTION OF THE SEGMENT 
CURRENTLY SCHEDULED TO I0S 






Offsets Offsets Offsets 
Equ Value Equ Value Equ Value 
Dec. (Hex. ) Dec. (Hex. ) Dec. (Hex. ) 
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Offsets Offsets 
Dec. (Hex. ) ee Dec. (Hex. } 
MMPFRRWA | 96 (60) | MMPFSEG | 36 (24) 
mMProc | 156 (9c) | MMPIOCHR | 156 (9c) | MMPIOERR | 162 X80" 
MMPIOF1 | 162 Caz) | MMPIOF2 | 161 cal) | MMPIOH | 158 (9E) 
(4s2c9s> | mmpzop— | 31 x80" | MMPIOR | 160 CAO) 
| 164 ca4y | mmprosB | 0 coy | MMProsBC | 64 (40) 
MMPIOSBF | 60 (3c) | MMPIOSBS | 56 (38) 124 (70) 
MMPIPIB 
MMPLBB. | 6 (6) =| MMPLBC) =| 8 (8) =| MMPLBCH 8 (8) 
MMPLBCHR 
MMPLBRBA | 8 (8) | MMPLBSK | 6 (6) | MMPLCI— | 
MMPLCNTL 
MMPLE 
MMPLECHR LMMPLECKD | 6 xto4" | MMPLEDBP | 20 (14) 
MMPLEH | 16 (10) | MMPLER | 18 (12) | MMPLESEC | 
MMPLISNP | 48 (30) | MMPLIST | 0 co) | MMPLISTC | 
MMPLISTF | 4 (4) | MMPLIST1 | 100 (64> | MMPLLR 
(2014) 
4 xtgor | 


Offsets 
Equ Value 
Dec. (Hex. ) 


rece | warner | 0 cor | wremnse 
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ICYMMPT: MEDIA MANAGER PURGE TABLE 
Pointed to by: ICYMMPT. 
Storage Location: Nucleus or system queue area. 


petit Contains addresses of active media manager process 
blocks. 


Created: As required during request processing. 


Released: Not released. 















Dec. (Hex. ) Length Description 

256 | tcvmmer | WeDIA MANAGER PURGE TABLE 
re werwoe [weaver 
248 







MPTNEXT NEXT MMPT 
MPTMMPB POINTER TO MMPB OR ZERO IF NONE 












Offsets Offsets Offsets 

Equ Value Equ Value Equ Value 

Dec. (Hex. ) Dec. (Hex. ) Dec. (Hex. ) 
ICYMMPT | 0 (0) MPTHDR 0 (0) MPTID Foo) | 
MPTMMPB 8 (8) MPTNEXT & (4) a ae 





ICYMMRE: MEDIA MANAGER REQUEST ELEMENT 
Pointed to by: ICYMMPB, Register l. 
Storage Location: Specified by calling program. 
Description: Used by the calling program to communicate 
requests for data to the media manager. Flags indicate whether a 
read or a write is requested. Includes the number of control 
intervals in the request, and the address of the next request 
element, if applicable. 
Created: By calling program. 


Released: By calling program. 
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ICYMMSB: MEDIA MANAGER STORAGE BLOCK 
Pointed to by: ICYMMSV. 
Storage Location: System queue area. 


Description: Describes the storage blocks that are owned and 
managed by the media manager. 


Created: As required during request processing. 


Released: By ICYELE when signaled by the system resource 
manager if the block is not in use. 










Offset 
Dec. (Hex. ) 


Description 


Lae Ea MEDIA MANAGER STORAGE BLOCK 


CHARACTERS MMSB 


re] stock | apbRess oF Lack FOR BLOCK CW WHSV) 
rece) | « | wwsrseo | appress oF Fins? SeonenT 

[4 | snnsn | ADDRESS oF NEXT WHSB ON OWNED CHAIN 
Tmsaseos | AREA FOR SEOENTS 
Twsasco | ALLOCATED on FREE SEORENT 
Timsswoe | SEONEWT HEADER 
wsswrsb | ADDRESS OF mHSD 


8 (8) MMSSUCHN | ADDRESS OF NEXT SEGMENT USED BY THIS 
REQUEST 
ASID OF THE OWNER OF THIS SEGMENT. 
FFFF IF FREE 


MMSSSTG REST OF SEGMENT 
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Offsets Offsets Offset’ 

Equ Value Equ Value Equ Value 

Dec. (Hex. ) Dec. (Hex. ) Dec. (Hex. } 
| Tits fo co |e | 0 cop 













ICYMMSV: MEDIA MANAGER STORAGE VECTOR 
Pointed to by: ICYMMSV. 
Storage Location: Nucleus or system queue area. 


pita Nha Contains the addresses of media manager storage 
ocks. 


Created: As required during request processing. 


Released: Not released. 





Offset 
Dec. (Hex. ) 


-uengtn | wane | peseription 
[ase | sevnisy | MEDIA WANAGER STORAGE VECTOR 
[ase | wwsvents | znpivibuaL ENTRIES 
re wsvent | wmsy ewrey 
r. 
Ey 
cee 






MMSVLOCK | LOCK FOR MMSB 
| MMSVCHN | CHAIN ENTRY (BITS 1 THRU 31 are 0's) 
MMSVADDR | ADDR IF MMSB OR NEXT MMSV 
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CROSS~-REFERENCE FOR HMSV 


Offsets Offsets Offsets 
Equ Value Equ Value Equ Value 
Name Dec. (Hex. ) Dec. (Hex. ) Dec. (Hex. ) 













ICYMMVT: MEDIA MANAGER VECTOR TABLE 
Pointed to by: CVTMMVT. 
Storage Location: Nucleus. 
Description: Contains addresses of media manager routines, a 
patch area, the first MMSV prefixed by the characters ICYMMSV1, 
and the first MMPT. 
Created: By link-editing media manager into the nucleus. 


Released: Not released. 






Offset 
Dec. (Hex. ) 


0 €0) 


3 (3) 
0 (0) 


G (4) 


8 (8) 
12 (C) 
20 (14) 
28 (1C) 


Name Description 
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MMVBL DCP M/M CHANNEL PROGRAM BUILD 
rReseeveD 








Offset 
Dec. (Hex. ) Length 






















72 (48) 
76 (€4C) 
80 ¢€50) 


88 (58) 
92 (5C) 
96 (60) 


104 (68) 
108 (6C) 


472 (€1D8) 
480 C1E0) 


736 (2E0) MMVMMPT1 






Offsets 
Equ Value 


Offsets Offsets 
Equ Value Equ Value 
Dec. (Hex. ) Name Dec. (Hex. ) Name Dec. (Hex. ) 


| MMVABN = | 76 (4C) MMVBLDCP | 56 (38) | MMVBLIST 







96 (60) MMVILPMB | 100 (64) 
MMVMMPTL | 736 (2E0) | MMVMMSRV 


MMVINIT 8 (8) 
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Offsets Offsets Offsets 
Equ Value Equ Value Ecu Value 
Dec. (Hex. ) Dec. (Hex. ) Dec. (Hex. ) 


MMVPATCH | 0 (0) | MMVPFAPP | 80 (50) | MMVPFCP 





MMVPTCH1 | 108 (6c) | MMVPURG | 88 (58) MMVRBA =| 24 (18) | 
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This section contains descriptions of dumps and tools that are 
used to collect and analyze diagnostic information for the media 
manager. 


A program check or other abend that occurs either in the media 
manager or in an exit routine will result in a summary dump of 
the media manager control blocks. This dump is written to the 
SYS1.DUMPxx data set using the SDUMP macro instruction. Also, an 
error record may be written out to SYS1.LOGREC in the event of 
an undetermined error. 


The media manager will provide a dump, using SDUMP, only if the 
operating environment was such that a functional recovery 
routine (FRR) could be established. An FRR is not established 
for functions invoked via the MMCNVT or MMINIT macros. 

pup eee invoked via the MMCALL procedure are protected by an 


Figure 5 is a sample of a summary dump. The first area is the 
SUMLIST RANGE, which shows the media manager vector table 
CMMVT). The second area is the range that shows the media 
manager process block (MMPB) that contains information on the 
current status of the media manager request. The third area, 
identified as the SDWA, is the system diagnostic work area and 
contains the name of the function and the name of the module 
last in control. The fourth area is the first register area, 
which starts with the registers in the interrupt handler save 
area and continues with the registers in the SDWA. 
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For certain errors that may occur when a media manager function 
is invoked, or a termination routine is called, return codes 
will be provided. 


Return codes are located in register 15 when control is returned 
to the program that called the media manager; in register zero, 
when the media nanager calls an exit routine. 


Return codes will have the format cceeffss; cece is the return 
code, ff is the module that detected the error, and SS is a 
status byte. 


The status byte represents the following: 


ss_ field Error Description 

00 No error. 

04 Warning. 

08 Extent error. 

oc Logic error. 

10 Permanent I/0 error. 

14 Error can't be determined. 


In combination with one of these status bytes, return codes in 
the cccc field indicate the following errors: 


ecce ff ss Error Description 


0000 -- 00 No errors. 

0000 -- 04 sr da DIE exit is receiving control in SRB 
mode. 

0010 -- 08 The end of a CI is out of its extent. 

0014 -- 08 Extent not found. 

0018 -- 08 Extent not active. 

04620 -- 08 Overlapping extents. 

0424 -- 08 Invalid ending RBA. 

0428 -~ 08 Block size is too large for the device. 

042C ~-- 08 Inconsistent CI sizes. 

0004 ~-- OC Two writes to the same RBA. 

0008 -- OC Two reads to the same buffer. 

0010 -- OC ee specifies output but MMIB specifies input 
only. 

000C -- OC An MMRE specifies multiple CIs to be sorted. 

0OO01lC -- OC Load real address error. Buffers not fixed. 

0020 -- OC Starting RBA not on CI boundary—preformat only. 

0024 -- OC Insufficient storage for channel program due to 
media manager storage constraints. 

0400 -- OC GETMAIN error for LPMB 

0408 -- OC Insufficient storage supplied for LPMB. 

0410 -- OC GETMAIN error for EDB. 

0418 -- OC Insufficient storage supplied for EDB. 

0434 -~ OC The parameter list is incomplete. 

0010 -- 10 I/0 prevented. 

0020 -- 10 Permanent I/0 error. 

0030 -- 14 Error can't be determined. 

0034 -- 14 Indeterminate error ~ I/0 has been started. 
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The ££ field of the return code identifies the module that has 
detected the error. These codes may also be found in the 


MMPMODID field of the MMPB. 
ff field Module 


== ICYMMSRV 
=< ICYMMVTC 
== ICYMSTAE 
01 ICYRDWR 
02 ICYFW 

03 ICYPFMT 
04 ICYRBA 
05 ICYCCHHR 
06 ICYSTOR 
07 ICYSORT 
08 ICYBLIST 
09 ICYELE 
OA ICYBLDCP 
OB ICYPFCP 
oc ICYDIE 
OD ICYPFDIE 
OE ICYNRM 
OF ICYABN 
10 ICYPFAPP 
li ICYPGAD 
12 ICYPURG 
13 ICYFRR 
40 ICYINIT 
41 ICYIEDB 
42 ICYILPMB 
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LIST OF ABBREVIATIONS 

ACDS. alternate control data set. 

APAR. authorized program analysis 
report. | 

CCHHR. es ll al peseriere 

Cos. control data set. 

CI. control interval. 

CSI. aleet-d Saha software 

CVT. communication vector table. 

DASD. direct access storage device. 

DIE. disabled interrupt exit. 

EDE. extent definition block. 

ENF. event notification facility. 

ESQA. extended system queue area. 

EWS. early warning system. 

FMID. function modification 
identifier. 

FRR. functional recovery routine. 

ros. I/0 supervisor. 

IOSB. I/O supervisor block. 

JCL. job control language. 
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K. 


LPMB. 


MMIB. 
MMPB. 
MMPT. 
MMRE. 
MMSB. 
MMSV. 
MMVT. 
RBA. 

RMID. 
SDWA. 
SMP. 


SMP/E. 


SRB. 
SRM. 
SSF. 
UCB. 
VSM. 


1024 (a kilobyte=1024 bytes). 


logical-to-physical mapping 
block. 


media manager interface block. 
media manager process block. 
media manager purge table. 
media manager request element. 
media manager storage block. 
media manager storage vector. 
media manager vector table. 
relative byte address. 

replace module identifier. 
system diagnostic work area. 
System Modification Program. 


System Modification Program 
Extended. 


service request block. 
system resource manager. 
Software Support Facility. 
unit control block. 


virtual storage manager. 
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